PC Media 2

home *** CD-ROM | disk | FTP | other *** search

/ PC Media 2 / PC MEDIA CD02.iso / share / udos / dst / dst.doc next >

Wrap

Text File | 1992-12-24 | 14.8 KB | 378 lines

DST: Disk Searching Tool v1.0 Released Dec 25, 1992 A DR-DOS / MS-DOS Fast File Finder Electronic mail on GEnie: J.Kowalczyk1 Program and Documentation are Copyright (c) 1991-1992 by: Bits, Bytes & PC's All rights reserved. Portions Copyright Borland, International. DST is written in Borland C. DST v1.0 Page 1 Definition of ShareWare Shareware distribution gives users a chance to try software before buying it. If you agree with the license agreement and continue using DST after 30 days, support the shareware concept by registering. By sending in the registration form you will receive the latest version of DST registered in you name. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. DST v1.0 Page 2 Disclaimer - Agreement Users of DST must accept this disclaimer of warranty: "DST is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of DST." DST is a "shareware program" and is provided at no charge to the user for evaluation. Feel free to share it with your friends, but please do not give it away altered or as part of another system. Shareware software is a way to provide personal computer users with quality software without paying high prices, and yet to provide incentive for programmers to continue to develop new software. If you find this program useful and find that you are using DST and continue to use DST after 30 days, you must become a registered owner of this software. You do this by filing out the registration form that came with DST and mail it in along with your payment. The registration fee will license you to use DST for use on any and all DR-DOS or MS-DOS based computers you or your company owns. This is a special licensing, just for DST and only DST. Please help distribute DST by giving your friends a copy to try and upload it to your favorite Bulletin Board System. Most BBS want you to upload a file after so many downloads, so please upload it. All registered users will receive a copy of the latest version of the DST program, registered in their name or company name. DST v1.0 Page 3 Introduction Thank you for taking the time to try out DST v1.0. I developed DST to help me find files on my hard disk using various searching methods. DST will not delete file(s) unless you answer a 'y' when asked to delete a file. I believe this is what scares most new users, DST is a fast file finding tool used to locate file(s) by Name, Date and Size. Even if you never used a tool like DST before please try it out, try doing something simple like looking for all the files that have a ext of DOC example C:\>dst *.doc -p this will locate all file(s) with extension of doc in any directory on your c: hard drive and pause after screen is full, it's that simple, once you try it you'll like it, I'm sure. DST also shows time in standard time format AM and PM 3:00p for 3 pm not 17:00 like most other file finders. DST when used with -p allow you to quit a search by entering a 'q' when it show's ---- more ---- (Y\N\Q). This is very handy and will take you back to starting directory well this was just a brief explanation of DST, complete instructions will follow later in this documentation. Registered users will not have to pay for any future versions of DST, they will receive a registration number that will register all versions of DST to them. Registration will remove the shareware screen from help and after using DST. There are a lot of disk searching programs out there, but I believe for the price DST is the best value and of course the source code is available for a small fee. Please register and support shareware THANK YOU... here are the options available to date: The ability to search for file by date, size or name using wildcard characters. The ability to delete files once found. The ability to change to the directory where file found resides. The ability to send output to screen and printer. The ability to end search when asked (Y\N\Q) by entering 'Q' DST builds a window and displays search item and parameters above this window and all output in this window so you can see what you are searching for at all times. I believe that you will find this software very useful if you have a hard disk in your computer, If you would like to see more features or a specific feature please list it on you registration form under comments. Or if you are a C programmer mail for the source code to DST and change or add any feature you like. All I ask of you if you purchase source code and modify it, is to include a message that thanks Bits, Bytes & PC's for the availability of the source code. Getting the source code and modifying it to your needs could be a real learning tool for a starting C programmer. DST v1.0 Page 4 Introduction When you send in your registration fee, you will receive a disk with the most recent version of DST. You will receive unlimited telephone support for the program. Registered DST users may call me at (208) 362-1151 between the hours of 6:00 pm - 10:00 pm (Mountain Time) Monday-Friday, and from 7 am - 10 pm on the weekends. Thank you for supporting DST. Using DST DST helps hard drive owners locate and perform certain tasks on file(s) scattered over their hard drive(s) in different directories. We've all had situations where we worked on a file or program but don't remember the name and or where it is located, with DST you can search the hard disk for this file by name (including wildcards) date and size using various options that I will list in more detail in a minute. DST v1.0 Page 5 OPTIONS: by typing DST by itself with no arguments will display a list of command parameters that are currently available. Example: C:\>DST Well this is probably the only area you will read so here are the options: DST *.doc will search default drive for any filename with extension of doc and display output to the screen. DST *.doc -p will search default drive for any filename with extension of doc and will stop after filling screen and only continue after you tap a key on the keyboard. DST d:*.doc -p same as above except will search the D drive. DST myprog search entire default drive looking for "myprog.*" (DST will append a ".*" to a filename when no extension is specified). DST myprog -gt122592 search entire default drive looking for "myprog", only with file date equal to or greater than dec 25, 1992. DST v1.0 Page 6 OPTIONS: Option: -G or -g Will allow you to change to directory where found file resides by answering with a 'y' or continuing by using a 'n', you also can enter a 'q' or 'Q' to quit the search you can enter options in either lower or upper case DST understands both so from this point on all reference to said options will be in lower case. example: dst *.doc -g Option: -D or -d Will allow you to DELETE found file, if you enter a 'y' to prompt (Y/N/Q/) ? . If you enter a 'y' file will be deleted and message Removed will appear on screen, Kept will appear if you answer with 'n'. you also can quit by answering prompt with 'q'. Option: -GT or -gt Will search for all file(s) equal to or greater than this date and list to screen. example: dst -gt112792 will list all file(s) equal to or greater than Nov 27, 1992. Option: -LT or -lt will find all file(s) less than this date and can only be used in conjunction with -gt option example: dst -gt112792 -lt122592 Will find all file(s) equal to or greater than Nov 27,1992 and all file(s) less than Dec 25, 1992. Option: -P Meaning: pause and wait for a key when the screen fills up Description: A very handy switch, best used when set in your environment variable. It will cause DST to pause the screen when it fills up, so you don't have to go crazy trying to hit the control-c key or pause key. You also can enter a 'Q' or 'q' when screen fills up. this will discontinue search and take you back to starting directory. DST v1.0 Page 7 OPTIONS: Option: -PR or -pr Will allow send all output from find to local printer example: dst *.doc -pr Option: -ET or -et Will find all file(s) equal to this date and only this date. example: dst -et122592 Option: -FG or -fg Will find all file(s) equal to and greater than filesize in bytes. example: -fg500000 Option: -FL or -fl Will find all file(s) with filesize less than this amount. this option can only be used in conjunction with -fg option. example: -fg 500000 -fl100000 Option: -FE or -fe Will find all file(s) with file size equal to this amount and only this amount. example: dst -fe50000 Option: Wildcard searching: example: dst ???-* or ???-*.* will find all file(s) with - in forth position with any characters or numbers in first three positions. files found might be: A-B-C.DOC, ART-1.EXE OR DOR--.COM DST v1.0 Page 8 OPTIONS: Option: dst -gt112792 -lt122592 -g -d Will find all file(s) with dates greater than or equal to Nov 27, 1992 and less than Dec 25, 1992 and will allow you to go to this directory or delete said found file. You will also have at -g or -d the option of quitting this search by hitting a 'Q' or 'q'. Option: dst -gt112792 -lt122592 -fg500 -fl100000 -g -d This will find all file(s) greater than or equal to date entered in -gt and less than file date in -lt with file size greater than or equal to and filesize less than in -lt plus all you to change to directory where file was found or delete said found file. Option: dst -gt112792 -lt122592 -fg500 -fl100000 -p This will find all file(s) greater than or equal to date entered in -gt and less than file date in -lt with file size greater than or equal to and filesize less than in -lt plus will stop and pause after screen is full and will wait for you to touch a key before continuing or you can hit a 'Q' or 'q' to quit and return to starting directory. as you can see you can mix many of the commands together to search for file(s) the way you want. For DST to work correctly, you need to put the file DST.EXE in a directory in you path, best place is in DOS directory or if you prefer somewhere else. At the dos prompt c:\>path and hit enter. example of path: path=c:\dos;c:\borlandc\bin;c:\windows;c:\dir\etc\ use dos copy command to put in directory of your choice. example: c:\>copy dst.exe \dos and hit enter key. That's all that's required to use DST. DST v1.0 Page 9 The source code to this program is available for $10.00 U.S. currency to obtain the commented source code please send payment to: Bits, Bytes & PC's c/o Joseph J Kowalczyk 11712 Gila dr. Kuna Id, 83634-2640 This will also make you a registered owner of DST and now you can add any feature(s) you wish and you don't have to pay any royalties for any updates or enhancements you make to this program. You can even change name, add new features and sell the program yourself. All I ask is you mention who the starting author was somewhere in your documentation. End of document.